<!DOCTYPE doctype PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN">

<HTML>
  <HEAD>
    <META name="generator" content=
    "HTML Tidy for Java (vers. 2009-12-01), see jtidy.sourceforge.net">

    <TITLE>View Defined Strings</TITLE>
    <META http-equiv="Content-Type" content="text/html; charset=windows-1252">
    <LINK rel="stylesheet" type="text/css" href="help/shared/DefaultStyle.css">
  </HEAD>

  <BODY lang="EN-US">
    <H1><a name="ViewStringsPlugin"></a>View Defined Strings</H1>

    <P>The View Defined Strings plugin will display all strings that have been explicitly defined
    in the program. You can click on the address column and navigate to the string in the <A href=
    "help/topics/CodeBrowserPlugin/CodeBrowser.htm">Listing</A>.</P>

    <P align="center"><IMG border="0" src="images/Defined_String_Table.png"></P>

    <P>&nbsp;</P>

    <P>This plugin is <I><B>not</B></I> intended to be used to locate undefined strings. Please see
    <A href="../Search/Search_for_Strings.htm">Search for Strings</A> or 
    <A href="../Search/Search_for_Strings.htm#Encoded_Strings_Dialog">Search for Encoded Strings</A> for this
    feature.</P>

	<h2>Defined Strings Table Columns</h2>
	<blockquote>
	<p>The Defined Strings table has several columns that display information about each
	string instance.</p>
	<ul>
	  <li>Location - address where string is found.  Double click in this column to navigate to the string.</li>
	  <li>String Value - raw value of string.</li>
	  <li>String Representation - formatted representation of the string (see 
	  <a href="../DataPlugin/Data.htm#StringSettings">String Settings</a> for formatting settings)
	  or the translated value of the string.  Double click in this column to change the string's 
	  representation into a value of your choice.  This is the
	  same as using the <b>Translate <IMG src="help/shared/arrow.gif" alt="-&gt;" border="0">
	  Manual</b> menu item.</li>
	  <li>Data Type - mnemonic or data type for the string type.</li>
	  <li>Is Ascii - boolean flag that indicates the string has non-ASCII characters.</li>
	  <li>Has Encoding Error - boolean flag that indicates the string had byte(s) that could not be converted by the character set.
	  This is usually caused by having the wrong character set or if the string isn't really a string.</li>
	  <li>Charset - name of the character set that this string is encoded in.</li>
	  <li>Unicode Script - a list of the the scripts (alphabets) used in the string.</li>
	</ul>
	<p>The <b>Is Ascii</b>, <b>Has Encoding Error</b>, <b>Unicode Script</b>, and <b>Charset</b> columns are not visible by default.  To display
	them in the table, right click on the column header row and select
	<b>Add/Remove Columns...</b>.</p>
	</blockquote>
	
	<h2>Defined Strings Menus and Actions</h2>
	<blockquote>
		<h3><a name="Make_Selection"></a>Make Selection</h3>
		<blockquote>
		<p>The Defined Strings window has an icon (<img src="Icons.MAKE_SELECTION_ICON">)
		on the tool bar to make a selection in the Code Browser. To make a selection,</p>
		<ol>
		  <li>&nbsp;Select the rows containing the desired strings in the table.</li>
		  <li>Right mouse click and select the <img src="Icons.MAKE_SELECTION_ICON"> <b>Make
		    Selection</b> option, OR select the <img src="Icons.MAKE_SELECTION_ICON">button on
		    the tool bar.</li>
		</ol>
		</blockquote>
	  
		<h3><a name="Refresh"></a>Refresh</h3>
		<blockquote>
		<p>The strings shown in the Defined Strings window can be refreshed by:</p>
		<ul>
		  <li>Right mouse click on any row and select the <img src="Icons.REFRESH_ICON"> <b>Refresh</b>
		  option, OR</li>
		  <li>Select the <img src="Icons.REFRESH_ICON">button on the tool bar.</li>
		</ul>
		
			<p><img border="0" src="help/shared/note.png">The refresh icon on the toolbar will
			appear grayed-out by default.  If potential changes to string data are detected, 
			the icon will become green in color.   The toolbar button can be pressed in either state
			for a full table reload.
		
		</blockquote>
		
		<h3><a name="Settings___"></a><a name="Default_Settings___"></a>Settings... and Default Settings...</h3>
		<blockquote>
		<p>Each data type in Ghidra allows different properties to be set on instances of that
		data type.  The <b>Settings...</b> action in the right click popup menu allow changing
		the settings for the highlighted rows.</p>
		<p>Typical settings available for string data instances:</p>
		<ul>
		  <li>Charset</li>
		  <li>Render non-ASCII Unicode</li>
		  <li>Translation</li>
		</ul>
		<p>The <b>Default Settings...</b> action allows changing the settings for all instances 
		of a specific data type.</p>
		<p>For more information, see <a href="../DataPlugin/Data.htm#StringSettings">string settings</a>.</p>
		</blockquote>
		
		<h3><a name="Translate"></a>Translate</h3>
		<blockquote>
		<p>Each string value can have a translated version of the value associated with it.  The
		translated value will be displayed in <b>&#x00BB;chevrons&#x00AB;</b> in the <b>String
		Representation</b> column.</p>
		<p>For more information, see <a href="../TranslateStringsPlugin/TranslateStringsPlugin.htm">Translate Strings Plugin</a>
		help.</p>
		</blockquote>
	</blockquote>
	
    <P align="center">&nbsp;</P>

    <P class="providedbyplugin">Provided by: <I>View Strings</I> Plugin</P>

    <P class="relatedtopic">Related Topics</P>

    <UL>
      <LI>
        <P class="relatedtopic"><A href="help/topics/Search/Search_for_Strings.htm">Search .. for
        Strings</A></P>
      </LI>

      <LI>
        <P class="relatedtopic"><A href=
        "help/topics/CodeBrowserPlugin/CodeBrowserOptions.htm#Operands_Field">Operand Field
        options</A></P>
      </LI>

      <LI>
        <P class="relatedtopic"><A href=
        "help/topics/CodeBrowserPlugin/CodeBrowser.htm">Listing</A></P>
      </LI>

      <LI>
        <P class="relatedtopic"><A href="../TranslateStringsPlugin/TranslateStringsPlugin.htm">Translate
        Strings Plugin</A></P>
      </LI>
      
      <LI>
        <P class="relatedtopic"><A href="../DataPlugin/Data.htm#StringDataTypes">String data types</A></P>
      </LI>
      
    </UL>
  </BODY>
</HTML>
